home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / help / dos / dosman / man / skip < prev    next >
Encoding:
Text File  |  1996-09-07  |  2.0 KB  |  75 lines
  1.  
  2.  
  3.  
  4.      Skip (V1.3 in C:) (2.x/3.x internal) 
  5.  
  6.  
  7.      NAME
  8.           Skip - Skip to the appropriate label.
  9.  
  10.      SYNOPSIS
  11.           Skip string [BACK]
  12.  
  13.      DESCRIPTION
  14.             Skip moves the currently executing script file ahead 
  15.         until it finds a lab declaration which matches its own 
  16.         argument.  If Skip is used without an argument, it looks 
  17.         for a null string designated by LAB.
  18.  
  19.             If you run skip without a label string or a LAB 
  20.         command then you will get the error message declaring 
  21.         'label not found by SKIP'.
  22.  
  23.             To Skip backwards in a file, you use the BACK 
  24.         keyword.
  25.  
  26.             If at any point in its search for a label Skip 
  27.         encounters the EndSkip command, it will abort the Skip 
  28.         and return an error of WARN.
  29.  
  30.  
  31.             By using the idiom "Skip ?", you can request a user 
  32.         to give you a label, and jump to that portion of the 
  33.         batch file.
  34.  
  35.             CAUTION: With the 1.3 version of SKIP, you should NOT 
  36.         indent a "Lab" statement or that label will not be found.
  37.  
  38.  
  39.  
  40.             Note that 2.x/3.x contains this command as a builtin.
  41.  
  42.      KEYWORDS
  43.           string
  44.             The text attached to a LAB command which SKIP 
  45.         searches for. The search always starts on the line 
  46.         following skip and continues downwoard toward the end of 
  47.         the file. SKIP always looks for the LAB keyword command 
  48.         preceding the Skip command, it will not goto a LAB 
  49.         command before the Skip unless the BACK keyword is used.
  50.  
  51.  
  52.           back
  53.             Added with 1.3, it starts at the Skip and searches 
  54.         back up the file towards the beginning. You may not skip 
  55.         backwards in an EXECUTE statement.
  56.  
  57.      EXAMPLE
  58.           1. To skip to Lab Dodah
  59.  
  60.  
  61.            Skip Dodah 
  62.  
  63.  
  64.           2. To skip down to the next LAB statement in the current
  65.              command file.
  66.  
  67.            Skip
  68.  
  69.           3. To skip to the LAB statement 'Here' before the current
  70.              skip statement in the current command file:
  71.  
  72.            Skip Here Back
  73.  
  74.  
  75.